package cn.iocoder.yudao.module.crm.service.module;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.crm.controller.admin.customer.vo.limitconfig.CrmCustomerLimitConfigPageReqVO;
import cn.iocoder.yudao.module.crm.controller.admin.customer.vo.limitconfig.CrmCustomerLimitConfigSaveReqVO;
import cn.iocoder.yudao.module.crm.controller.admin.module.vo.customerlimit.CrmModuleCustomerLimitPageReqVO;
import cn.iocoder.yudao.module.crm.controller.admin.module.vo.customerlimit.CrmModuleCustomerLimitSaveReqVO;
import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerLimitConfigDO;
import cn.iocoder.yudao.module.crm.dal.dataobject.module.CrmModuleCustomerLimitDO;

import javax.validation.Valid;
import java.util.List;

/**
 * 客户限制配置 Service 接口
 *
 * @author Wanwan
 */
public interface CrmModuleCustomerLimitService {

    /**
     * 创建客户限制配置
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createCustomerLimit(@Valid CrmModuleCustomerLimitSaveReqVO createReqVO);

    /**
     * 更新客户限制配置
     *
     * @param updateReqVO 更新信息
     */
    void updateCustomerLimit(@Valid CrmModuleCustomerLimitSaveReqVO updateReqVO);

    /**
     * 删除客户限制配置
     *
     * @param id 编号
     */
    void deleteCustomerLimit(Long id);

    /**
     * 获得客户限制配置
     *
     * @param id 编号
     * @return 客户限制配置
     */
    CrmModuleCustomerLimitDO getCustomerLimit(Long id, Integer type);

    /**
     * 获得客户限制配置分页
     *
     * @param pageReqVO 分页查询
     * @return 客户限制配置分页
     */
    PageResult<CrmModuleCustomerLimitDO> getCustomerLimitPage(CrmModuleCustomerLimitPageReqVO pageReqVO);

    /**
     * 查询用户对应的配置列表
     *
     * @param type   类型
     * @param userId 用户类型
     */
    List<CrmModuleCustomerLimitDO> getCustomerLimitListByUserId(Long moduleId, Integer type, Long userId);

    /**
     * 获取指定模块指定用户的领取上限，返回-1时表示没有配置，可以无限领取
     * @param moduleId 模块id
     * @param type
     * @param userId
     * @since 2024-06-25
     * @author PetePower
     * @return
     */
    Integer getUserOwnerLimit(Long moduleId, Integer type, Long userId);

    /**
     * 获取配置的领取上限的时效类型
     * @param moduleId
     * @param type
     * @since 2024-06-25
     * @author PetePower
     * @return
     */
    Integer getSubTypeByModuleId(Long moduleId, Integer type);

}
